home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Skunkware 5
/
Skunkware 5.iso
/
man
/
cat.3
/
CallDel.3
< prev
next >
Wrap
Text File
|
1995-07-25
|
5KB
|
133 lines
TTTTccccllll____CCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd((((3333)))) TTTTccccllll ((((7777....0000)))) TTTTccccllll____CCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd((((3333))))
_________________________________________________________________
NNNNAAAAMMMMEEEE
Tcl_CallWhenDeleted, Tcl_DontCallWhenDeleted - Arrange for
callback when interpreter is deleted
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<ttttccccllll....hhhh>>>>
TTTTccccllll____CCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd(_i_n_t_e_r_p, _p_r_o_c, _c_l_i_e_n_t_D_a_t_a)
TTTTccccllll____DDDDoooonnnnttttCCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd(_i_n_t_e_r_p, _p_r_o_c, _c_l_i_e_n_t_D_a_t_a)
AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
Tcl_Interp *_i_n_t_e_r_p (in) Interpreter
with which to
associated
callback.
Tcl_InterpDeleteProc *_p_r_o_c (in) Procedure to
call when
_i_n_t_e_r_p is
deleted.
ClientData _c_l_i_e_n_t_D_a_t_a (in) Arbitrary
one-word value
to pass to
_p_r_o_c.
_________________________________________________________________
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
TTTTccccllll____CCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd arranges for _p_r_o_c to be called by
TTTTccccllll____DDDDeeeelllleeeetttteeeeIIIInnnntttteeeerrrrpppp if/when _i_n_t_e_r_p is deleted at some future
time. _P_r_o_c will be invoked just before the interpreter is
deleted, but the interpreter will still be valid at the time
of the call. _P_r_o_c should have arguments and result that
match the type TTTTccccllll____IIIInnnntttteeeerrrrppppDDDDeeeelllleeeetttteeeePPPPrrrroooocccc:
typedef int Tcl_InterpDeleteProc(
ClientData _c_l_i_e_n_t_D_a_t_a,
Tcl_Interp *_i_n_t_e_r_p);
The _c_l_i_e_n_t_D_a_t_a and _i_n_t_e_r_p parameters are copies of the
_c_l_i_e_n_t_D_a_t_a and _i_n_t_e_r_p arguments given to
TTTTccccllll____CCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd. Typically, _c_l_i_e_n_t_D_a_t_a points to an
application-specific data structure that _p_r_o_c uses to
perform cleanup when an interpreter is about to go away.
_P_r_o_c does not return a value.
TTTTccccllll____DDDDoooonnnnttttCCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd cancels a previous call to
TTTTccccllll____CCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd with the same arguments, so that _p_r_o_c
won't be called after all when _i_n_t_e_r_p is deleted. If there
is no deletion callback that matches _i_n_t_e_r_p, _p_r_o_c, and
Page 1 (printed 7/10/95)
TTTTccccllll____CCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd((((3333)))) TTTTccccllll ((((7777....0000)))) TTTTccccllll____CCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd((((3333))))
_c_l_i_e_n_t_D_a_t_a then the call to TTTTccccllll____DDDDoooonnnnttttCCCCaaaallllllllWWWWhhhheeeennnnDDDDeeeelllleeeetttteeeedddd has no
effect.
KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
callback, delete, interpreter
Page 2 (printed 7/10/95)